window: Document GtkWindow::set-focus
authorColin Walters <walters@verbum.org>
Thu, 2 Jan 2014 23:40:17 +0000 (18:40 -0500)
committerColin Walters <walters@verbum.org>
Fri, 3 Jan 2014 01:04:47 +0000 (20:04 -0500)
Not sure why this was never documented.

gtk/gtkwindow.c

index ecb5a8b85d75b9e777c1bbcb6112f3f6722b7589..2c758ec61ff2ff675d77ef03303a131a57cb52fb 100644 (file)
@@ -1118,6 +1118,16 @@ gtk_window_class_init (GtkWindowClass *klass)
                                                         GTK_TYPE_APPLICATION,
                                                         GTK_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 
+  /**
+   * GtkWindow:set-focus:
+   * @window: the window which received the signal
+   * @widget: the newly focused widget (or %NULL for no focus)
+   *
+   * This signal is emitted whenever the currently focused widget in
+   * this window changes.
+   *
+   * Since: 2.24
+   */
   window_signals[SET_FOCUS] =
     g_signal_new (I_("set-focus"),
                   G_TYPE_FROM_CLASS (gobject_class),